------------------------------------------------------------
Range Stats Viewer
------------------------------------------------------------
Version: 1.0
Author : TOKYO-EA
Python : 3.13 / FreeSimpleGUI / PyInstaller
Build  : Standalone Windows Executable

------------------------------------------------------------
【概要】
------------------------------------------------------------
Range Stats Viewer は、MT4 のヒストリカルデータから出力した
「高値・安値・値幅（Range）」CSV を読み込み、
以下の分析を行うためのツールです。

・過去 n 本のデータから値幅を抽出
・上位／下位の値幅を除外（M/L）
・上位 K 本 または 下位 K 本 を選別して平均を算出
・並び替え機能（Range 広い順／狭い順、日付昇順/降順）
・平均値幅を pips 換算して表示
・詳細リストを画面に一覧表示

利確ターゲットの基準作成や、直近のボラティリティ調査に利用できます。

------------------------------------------------------------
【対応ファイル】
------------------------------------------------------------
MT4 スクリプトで出力した以下の形式の CSV に対応します：

Timeframe,Index,Datetime,High,Low,Range
PERIOD_D1,119,2025.06.02 00:00,143.987,142.537,1.45
...

・区切り文字はカンマ
・文字コードは CP932（Shift-JIS）

------------------------------------------------------------
【使い方】
------------------------------------------------------------
1. 「参照」ボタンから CSV ファイルを選択します。
2. 過去 n 本（N）、上位除外本数（M）、下位除外本数（L）を入力します。
   - N を空欄 → 全データ利用
   - M/L を 0 → 除外なし
3. 並び替え方法を選択します。
4. 選別方法（上位／下位）と K 本数を指定します。
   - K を空欄 → usable 全件を利用
5. 「計算実行」を押すと、平均値幅と詳細が表示されます。

------------------------------------------------------------
【EXE の実行方法】
------------------------------------------------------------

    Range Stats Viewer.exe

をダブルクリックするだけで実行できます。
ライブラリ類は不要です。

------------------------------------------------------------
【既知の制限】
------------------------------------------------------------
・MT4 CSV の列名が変更されている場合は読み込みできません。
・値幅（Range）は数値として認識できる必要があります。
・日付形式は「YYYY.MM.DD HH:MM」形式のみ対応。

------------------------------------------------------------
【著作権 / ライセンス】
------------------------------------------------------------
本ツールは MIT ライセンスで公開しています。
詳細は同梱の LICENSE.txt をご覧ください。

Copyright (c) 2025 TOKYO-EA
------------------------------------------------------------
